// 这个组件根据传入的图标类名来显示对应的SVG图标,支持外部图标和普通SVG图标的显示和样式设置
<template>
  <!--用于显示SVG图标。它根据传入的图标类名来决定显示的图标类型。  
   首先判断是否为外部图标（isExternal），外部图标使用一个div元素来显示，通过设置样式和绑定事件来实现
   如果是，则显示一个外部图标的样式，否则显示一个普通的SVG图标。
  -->
  <div
    v-if="isExternal"
    :style="styleExternalIcon"
    class="svg-external-icon svg-icon"
    v-on="$listeners"
  />
  <svg v-else :class="svgClass" aria-hidden="true" v-on="$listeners">
    <!-- 其中，xlink:href属性指定了要引用的Symbol的ID。通过这种方式，我们可以轻松地在SVG中插入Symbol，并在需要时进行修改和更新。 -->
    <use :xlink:href="iconName" />
  </svg>
</template>

<script>
// doc: https://panjiachen.github.io/vue-element-admin-site/feature/component/svg-icon.html#usage
// 于判断图标是否为外部图标。
import { isExternal } from "@/utils/validate";

export default {
  name: "SvgIcon",
  props: {
    // 用于指定图标的类名；
    iconClass: {
      type: String,
      required: true,
    },
    // className是可选的，用于指定额外的类名。
    className: {
      type: String,
      default: "",
    },
  },
  computed: {
    // isExternal用于判断图标是否为外部图标，
    isExternal() {
      return isExternal(this.iconClass);
    },
    // iconName用于生成图标的ID
    iconName() {
      return `#icon-${this.iconClass}`;
    },
    // svgClass用于生成SVG图标的类名，
    svgClass() {
      if (this.className) {
        return "svg-icon " + this.className;
      } else {
        return "svg-icon";
      }
    },
    // styleExternalIcon用于生成外部图标的样式。
    styleExternalIcon() {
      return {
        mask: `url(${this.iconClass}) no-repeat 50% 50%`,
        "-webkit-mask": `url(${this.iconClass}) no-repeat 50% 50%`,
      };
    },
  },
};
</script>

<style scoped>
/* 定义SVG图标 */
.svg-icon {
  width: 1em;
  height: 1em;
  vertical-align: -0.15em;
  fill: currentColor;
  overflow: hidden;
}

/* 外部图标的样式。 */
.svg-external-icon {
  background-color: currentColor;
  mask-size: cover !important;
  display: inline-block;
}
</style>
